home *** CD-ROM | disk | FTP | other *** search
/ Aminet 15 / Aminet 15 - Nov 1996.iso / Aminet / dev / gcc / ixemsdk.lha / man / cat2 / getgroups.0 < prev    next >
Text File  |  1996-09-01  |  2KB  |  43 lines
  1.  
  2. GETGROUPS(2)               UNIX Programmer's Manual               GETGROUPS(2)
  3.  
  4. NNAAMMEE
  5.      ggeettggrroouuppss - get group access list
  6.  
  7. SSYYNNOOPPSSIISS
  8.      ##iinncclluuddee <<ssyyss//ppaarraamm..hh>>
  9.      ##iinncclluuddee <<ssyyss//ttyyppeess..hh>>
  10.      ##iinncclluuddee <<uunniissttdd..hh>>
  11.  
  12.      _i_n_t
  13.      ggeettggrroouuppss(_i_n_t _g_i_d_s_e_t_l_e_n, _g_i_d___t _*_g_i_d_s_e_t)
  14.  
  15. DDEESSCCRRIIPPTTIIOONN
  16.      GGeettggrroouuppss() gets the current group access list of the current user pro-
  17.      cess and stores it in the array _g_i_d_s_e_t. The parameter _g_i_d_s_e_t_l_e_n indicates
  18.      the number of entries that may be placed in _g_i_d_s_e_t. GGeettggrroouuppss() returns
  19.      the actual number of groups returned in _g_i_d_s_e_t. No more than
  20.      {NGROUPS_MAX} will ever be returned.  If _g_i_d_s_e_t_l_e_n is 0, ggeettggrroouuppss() re-
  21.      turns the number of groups without modifying the _g_i_d_s_e_t array.
  22.  
  23. RREETTUURRNN VVAALLUUEESS
  24.      A successful call returns the number of groups in the group set.  A value
  25.      of -1 indicates that an error occurred, and the error code is stored in
  26.      the global variable _e_r_r_n_o.
  27.  
  28. EERRRROORRSS
  29.      The possible errors for ggeettggrroouuppss() are:
  30.  
  31.      [EINVAL]      The argument _g_i_d_s_e_t_l_e_n is smaller than the number of groups
  32.                    in the group set.
  33.  
  34.      [EFAULT]      The argument _g_i_d_s_e_t specifies an invalid address.
  35.  
  36. SSEEEE AALLSSOO
  37.      setgroups(2),  initgroups(3)
  38.  
  39. HHIISSTTOORRYY
  40.      The ggeettggrroouuppss() function call appeared in 4.2BSD.
  41.  
  42. 4.2 Berkeley Distribution       April 16, 1994                               1
  43.